home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 1 Issue 2 / PDCD-1 - Issue 02.iso / _utilities / utilities / 003 / _multiobey / !MultiObey / !Help < prev    next >
Text File  |  1994-09-19  |  8KB  |  166 lines
  1. Multitasking Obey version 1.10
  2. ⌐ Sam Kington 10th August 1994
  3. This program is freeware, *not* public domain ù i.e., I retain copyright (see
  4. öBoring legal messageò)
  5.  
  6. What this program does
  7. **********************
  8.  
  9.    This program, as itæs name suggests, allows you to multitask Obey files,
  10. allowing the Desktop time to catch up between each line. It is best suited to
  11. medium or long files that spend quite a lot of time on each line ù such as
  12. Boot ₧les, or Obey ₧les that do a lot of ₧le copying. However, it will slow
  13. down considerably long ₧les, with lines that execute very rapidly ù setting
  14. variables, for instance ù and isnæt worth it for short ₧les. On no account
  15. should you use it on ₧les that set the WimpSlot (such as !Run ₧les), and
  16. therefore it will refuse to run a !Run or !Boot ₧le.
  17.  
  18.    When given a ₧le to run, it steps through it line by line; when it ₧nds a
  19. öusefulò line (i.e. one that is neither blank or a comment), it starts that
  20. command as a new Wimp Task (using Wimp_StartTask), and updates the progress
  21. window to hold the text of the line just executed, an appropriate icon, and
  22. updates the slider to give some idea of the amount of the ₧le still to come.
  23.  
  24.    The advantage of MultiObey over Obey ₧les or Desktop ₧les is that it gives
  25. you a (hopefully) useful idea of where you are in the ₧le and what is
  26. happening; as it fully multitasks, it allows tasks that have been started up
  27. by the ₧le to put their icons on the icon bar, update the screen, etc. etc.,
  28. so you can see something is happening. This is especially useful for Boot
  29. sequences, as mentioned earlier.
  30.  
  31. Using Multi Obey
  32. ****************
  33.  
  34.    There are two different ways to make MultiObey run a ₧le. The ₧rst is to
  35. set an Obey ₧le to type MultObey (type &212 - NB:this is not a registered
  36. ₧letype). Running, double-clicking or Filer_Running the ₧le will pass it to
  37. MultiObey. The second is to run the command MultiObey <₧le>, if you want to
  38. force MultiObey to run a ₧le of a different type.
  39.  
  40.    Warning: although it is possible to set MultiObey to run all Obey ₧les, by
  41. running the command Set Alias$@RunType_FEB MultiObey %*0 (replace the % by %%
  42. if this is in an Obey ₧le), there are very good reasons why you would not
  43. want to do this: not only are all Obey ₧les not appropriate for the
  44. multitasking treatment (see above), but some Obey ₧les do not take kindly to
  45. being multi-tasked, and complain, or hang the machine. I donæt know whose
  46. fault this is (itæs probably mine), but you have been warned.
  47.  
  48.    In other words, although MultiObey is primarily designed to be a
  49. multitasking Boot, you may have fatal errors which hang the machine from time
  50. to time. Sometimes they go away if you restart the machine, sometimes they go
  51. away if you change the order of the commands in the ₧le. Most programs arenæt
  52. expecting to be run from a multitasking boot ₧le, and while you should hardly
  53. ever have any problems, you have been warned: this is a complex process that
  54. can sometimes go wrong. Exactly how complex it is can be measured by pausing
  55. the process, watch the disc continue to whirr, and then notice the
  56. applications that had already been started, only now be initialised:
  57. MultiObey has moved on to other things, but the processes it has started up
  58. havenæt ₧nished yet.
  59.  
  60. Advanced features
  61. *****************
  62.  
  63.    Apart from sitting back and enjoying the view, there are four buttons you
  64. can click on for more control over the process:
  65.    Å Abort        : Stops everything, closes the window.
  66.    Å Skip         : Skips this line, moves to the next one. Only useful if
  67.                     Pause is  on (see below).
  68.    Å Step through : When selected, allows you to step through the ₧le line by
  69.                     line, rather than them all being executed one after the
  70.                     other.
  71.    Å Pause        : Pauses execution of the ₧le; the button then changes to
  72.                     öContinueò. Clicking on öContinueò continues execution of
  73.                     the ₧le.
  74.    Whatever the situation, the main part of the window will show the next
  75. line to be executed. When Paused, therefore, clicking Skip will skip the
  76. currently shown line and show the next one; clicking Continue will start
  77. execution again at the new line. If Step through is selected, the ₧le will
  78. automatically be Paused after each line; press Skip to move to the next line
  79. or Continue to execute it.
  80.  
  81.    NB: The slider at the top is not necessarily a good indicator of how much
  82. longer the ₧le will take, as it has no idea how long each line will take.
  83. What it actually measures is the position in the ₧le of the current line,
  84. which will be approximately the same as the time taken/remaining if each line
  85. takes approximately the same time. If, however, different lines take very
  86. different times to execute, the bar will move erratically, in jumps.
  87.  
  88. Miscellanea
  89. ***********
  90.  
  91.    You can run several copies of MultiObey at the same time, in which case
  92. the earlier copies are suspended until the latest has ₧nished. The windows
  93. are offset from each other so you can see how many are running at once.
  94.  
  95.    By default, MultiObey will display the name of the ₧le it is processing in
  96. the title bar of its window, centred. However, if the ₧lename gets too long,
  97. it will right-justify it so you can see the leaf-name (presumably you know
  98. the bit at the left). Cunning, cunning...
  99.  
  100. Boring legal message
  101. ********************
  102.  
  103.    This application is freeware, that is, it can be distributed freely as
  104. long as only reasonable charges are made for media and distribution. I retain
  105. copyright on all program code and documentation.
  106.  
  107.    This software is supplied öasáisò: I make no warranty, expressed or
  108. implied, of the merchantability of this software or its ₧tness for any
  109. particular purpose. In no circumstances shall I be liable for any damage,
  110. loss of pro₧ts, or any indirect or consequential loss arising out of the use
  111. of this software or inability to use this software, even if I have been
  112. advised of the possibility of such loss.
  113.  
  114.    In other words, if your computer crashes, blows up, you lose all your work
  115. etc. all because of MultiObey (unlikely I know), donæt blame me.
  116.  
  117. About all these strange foreign characters in this ₧le
  118. *******************************************************
  119.  
  120.    OK, so if youære reading this on a PC or a Mac or another strange machine
  121. like that, you may be wondering what all these strange ae things are. Well,
  122. theyære quotes (sorry, there was another one), dashes, ligatures, etc.
  123. Honest. But not on all machines...
  124.    Basically, character sets are only standard up to character 127, which is
  125. basically alphanumerics and a few standard punctuation marks. Foreign
  126. characters, typographical oddities like quotes and ligatures, and other more
  127. obscure symbols are önon-standardò, and each computer often has its own idea
  128. of where they should go in the character set. So donæt worry: even if itæs
  129. hard to read on your current machine, it wonæt be on an Acorn machine. It may
  130. look slightly strange if youære using the System font, however.
  131.    But why am I using these strange characters in the ₧rst place? Well,
  132. theyære in the character set and they look nice in an outine font, and Iæve
  133. written a program called Smart Quotes (sorry for the plug) that substitutes
  134. these sort of characters automatically, and Iæve got it turned on at the
  135. moment...
  136.  
  137. How to contact me
  138. *****************
  139.  
  140. All bug-reports, suggestions, comments or indeed any feedback at all will be
  141. welcomed. Hereæs how to get to me:
  142.  
  143. E-mail     : 9262861k@arts.gla.ac.uk, 926286ki@udcf.gla.ac.uk during term-time
  144.              These should be OK until June 1996
  145.              At Christmas, Easter and during the summer, you can get me at
  146.              wombat@altern.com, wombat@email.teaser.com or sam@altern.com, in order
  147.              of preference (that is, if mail bounces off one of these or I donæt
  148.              answer within a week send to the next one).
  149.  
  150. Snail-mail : My term-time address, at least until June 1995, is:
  151.              Sam Kington
  152.              Flat 2/1
  153.              44 Hotspur Street
  154.              Glasgow G20 8NL
  155.              SCOTLAND
  156.              
  157.              Again, a backup is the home address ù anything that goes here will get
  158.              to me eventually.
  159.              Sam Kington
  160.              Merlhiot
  161.              24420 Savignac les Eglises
  162.              FRANCE
  163.  
  164. Term-time is October to June, with bits off at Christmas (3 weeks) and
  165. Easter (4 weeks).
  166.